Start SQL Agent Job
Description
This plugin is designed to Start Agent Job to handle other automated tasks. This step only ensures start of SQL agent job and not monitoring the completion of action(s) (successful execution) present in the job.
Prerequisites:
- SQL Server instance and access details
- SQL Server Browser service must be enabled on remote machine.
- SQL Server Agent must be enabled.
- sqljdbc4-4.0.jar must be present in lib folder of Process Studio as well as AE agent.
- SQL Server has the following msdb database fixed database roles, which gives administrators control over access to SQL Server Agent. The roles are:
- SQL Agent User Role
- SQL Agent Reader Role
- SQL Agent Operator Role
Configurations
| No. | Field Name | Description |
|---|---|---|
| 1 | Step Name | Name of the step. This name has to be unique in a single workflow. |
| Connection: | ||
| 2 | Server Name | The Hostname/Server Name/IP of the MSSQL Server. This field is mandatory. Drop down is available. |
| 3 | Instance name | The instance name of MSSQL Server instance. One of the two fields Instance name or Port is mandatory. Only variables/static values are allowed. |
| 4 | Port Number | The port number of the MSSQL Server. One of the two fields Instance name or Port is mandatory. Only variables/static values are allowed. |
| 5 | Username | A username of the MSSQL Server. This field is mandatory. |
| Password | ||
| 6 | Password | Specify or select the password, as required. If the checkbox Accept Value as variable/static is selected, then the password field appears as a text box and accepts static or variable values. OR If the checkbox Accept Value as variable/static is not selected, then the password field appears as a dropdown in which you can select a field from the previous steps. |
| 7 | Other Connection Parameter | Specify multiple, semi-colon separated parameters other than the default connection parameters. Other connection parameters will be appended to the default connection parameters. Example of default connection parameters: Server Name, Password. Examples of other connection parameters: encrypt=false;trustServerCertificate=false |
| Button | ||
| 8 | Test Connection | Verifies whether the connection is established or not. NOTE: Test Connection button does not work for previous step fields. Test Connection button only works with static values and environment variables. |
| Input Fields | ||
| 1 | Job Name | Name of the job to start. |
| 2 | Button: Get | Clicking on this button brings a dialog for the available jobs on that particular SQL server instance.Get Button will work for user having system admin’s permission or having agent roles mentioned below with access on msdb.dbo.sysjobs table. |
| Output Fields: | ||
| 1 | Result | Output field to hold the result of the successful plugin execution |